Vue 3.5 正式版发布,都有哪些变化?
编者按:Vue 官方今天发布 Vue 3.5 正式版,我们一起来看看都有哪些变化?
今天我们很兴奋地宣布 Vue 3.5 “天元突破红莲螺岩”版本发布!
https://github.com/vuejs/core/blob/main/CHANGELOG.md
响应式系统优化
在 3.5 中,Vue 的响应式系统经历了又一次重大重构,实现了更好的性能和显著减少了内存占用(-56%),且没有行为变化。这次重构还解决了 SSR 过程中由于悬挂的计算属性导致的过时计算值和内存问题。
此外,3.5 还优化了对大型、深度响应式数组的响应式追踪,在某些情况下使此类操作的速度提高了多达 10 倍。
响应式 Props 解构
响应式 Props 解构在 3.5 中已经稳定。该功能现在默认启用,在 <script setup>
中从 defineProps
调用解构的变量现在是响应式的。值得注意的是,这个功能通过利用 JavaScript 的原生默认值语法,大大简化了声明带有默认值的 props:
Before
const props = withDefaults(
defineProps<{
count?: number
msg?: string
}>(),
{
count: 0,
msg: 'hello'
}
)
After
const { count = 0, msg = 'hello' } = defineProps<{
count?: number
message?: string
}>()
访问解构变量(例如 count
)时,编译器会自动将其编译为 props.count
,因此它们在访问时会被追踪。与 props.count
类似,如果要观察解构的 prop 变量或将其传递给组合式函数并保持响应性,需要将其包装在一个 getter 中:
watch(count /* ... */)
// ^ results in compile-time error
watch(() => count /* ... */)
// ^ wrap in a getter, works as expected
// composables should normalize the input with `toValue()`
useDynamicCount(() => count)
对于那些更喜欢将解构的 props 与普通变量区分开来的人,@vue/language-tools
2.1 版本已经发布了一个可选设置,可以为它们启用内联提示:
详情:
使用方法和注意事项请参阅文档。
有关此功能的历史和设计理念,请参阅 RFC#502。
https://vuejs.org/guide/components/props.html#reactive-props-destructure
https://github.com/vuejs/rfcs/discussions/502
SSR 改进
3.5 为服务器端渲染(SSR)带来了一些期待已久的改进。
Lazy Hydration 懒加载水合
异步组件现在可以通过 defineAsyncComponent()
API 的 hydrate
选项来控制何时进行水合。例如,只在组件变为可见时才进行水合:
import { defineAsyncComponent, hydrateOnVisible } from 'vue'
const AsyncComp = defineAsyncComponent({
loader: () => import('./Comp.vue'),
hydrate: hydrateOnVisible()
})
核心 API 故意设计得比较底层,Nuxt 团队已经在这个功能之上构建了更高级的语法糖。
useId()
useId()
是一个可以用来生成应用内唯一 ID 的 API,这些 ID 保证在服务器和客户端渲染之间保持稳定。它们可以用于生成表单元素和无障碍属性的 ID,并且可以在 SSR 应用中使用而不会导致水合不匹配:
<script setup>
import { useId } from 'vue'
const id = useId()
</script>
<template>
<form>
<label :for="id">Name:</label>
<input :id="id" type="text" />
</form>
</template>
data-allow-mismatch
在客户端值不可避免地与其服务器端对应值不同的情况下(例如日期),我们现在可以使用 data-allow-mismatch
属性来抑制由此产生的水合不匹配警告:
<span data-allow-mismatch>{{ data.toLocaleString() }}</span>
您还可以通过为该属性提供一个值来限制允许哪些类型的不匹配,可能的值包括 text
、children
、class
、style
和 attribute
。
自定义元素改进
3.5 修复了许多与 defineCustomElement()
API 相关的长期存在的问题,并为使用 Vue 创建自定义元素添加了一些新功能:
通过
configureApp
选项支持自定义元素的应用配置。添加
useHost()
、useShadowRoot()
和this.$host
API,用于访问自定义元素的宿主元素和影子根。通过传递
shadowRoot: false
支持挂载不带影子 DOM 的自定义元素。支持提供
nonce
选项,该选项将附加到自定义元素注入的<style>
标签上。
这些新的仅用于自定义元素的选项可以通过第二个参数传递给 defineCustomElement
:
import MyElement from './MyElement.ce.vue'
defineCustomElements(MyElement, {
shadowRoot: false,
nonce: 'xxx',
configureApp(app) {
app.config.errorHandler = ...
}
})
其他值得关注的特性
useTemplateRef()
3.5 引入了一种通过 useTemplateRef()
API 获取模板引用的新方法:
<script setup>
import { useTemplateRef } from 'vue'
const inputRef = useTemplateRef('input')
</script>
<template>
<input ref="input">
</template>
在 3.5 之前,我们建议使用普通的 ref,其变量名与静态 ref
属性匹配。旧方法要求 ref
属性可以被编译器分析,因此仅限于静态 ref
属性。相比之下,useTemplateRef()
通过运行时字符串 ID 匹配 ref,因此支持动态 ref 绑定到变化的 ID。
@vue/language-tools
2.1 也为新语法实现了特殊支持,因此在使用 useTemplateRef()
时,根据ref属性存在与否会有自动完成和警告出现:
Deferred Teleport 延迟传送门
内置 <Teleport>
组件的一个已知限制是,其目标元素必须在传送门组件挂载时存在。这阻止了用户将内容传送到 Vue 在传送门之后渲染的其他元素。
<Teleport>
<Teleport defer to="#container">...</Teleport>
<div id="container"></div>
这种行为需要 defer
属性,因为默认行为需要向后兼容。
有关 3.5 中变更和功能的完整列表,请查看 GitHub 上的完整更新日志。
https://github.com/vuejs/core/blob/main/CHANGELOG.md
祝编码愉快!